home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload Trio 2 / Shareware Overload Trio Volume 2 (Chestnut CD-ROM).ISO / dir28 / sop9435a.zip / SETUP.DOC < prev    next >
Text File  |  1994-08-22  |  12KB  |  258 lines

  1. Program STSORBIT PLUS Satellite Orbit Simulation                   Page 1
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                            Program STSORBIT PLUS
  8.  
  9.                Space Shuttle and Satellite Orbit Simulation
  10.  
  11.              (Enhanced Version for 386/486/Pentium Computers)
  12.  
  13.  
  14.                                Version  9435
  15.                               August 22, 1994
  16.  
  17.  
  18.  
  19.  
  20.                           by David H. Ransom, Jr.
  21.                        Rancho Palos Verdes, CA  USA
  22.  
  23.  
  24.                           Bulletin Board Systems
  25.                           ----------------------
  26.  
  27.                              RPV ASTRONOMY BBS
  28.                      (310) 541-7299 @ 2400-14400 Baud
  29.  
  30.  
  31.  
  32.  
  33. IMPORTANT NOTE REGARDING COMPATIBILITY WITH EARLIER VERSIONS
  34. ------------------------------------------------------------
  35.  
  36.      STSORBIT PLUS Version 9333 and higher represent a major upgrade to the 
  37. program and adds multi-satellite tracking capability. See the documentation 
  38. and file STSPLUS.NEW for a full description of the changes. As part of this 
  39. upgrade, the format of file STSPLUS.INI has been completely reworked and 
  40. any prior version of the file will be ignored. ALL PROGRAM OPTIONS MUST BE 
  41. RESET! The distribution package includes a sample STSPLUS.INI file 
  42. configured to suit my own preferences and which defaults all paths to the 
  43. directory from which the program is started. If you are upgrading, use F7 
  44. from the Main Menu to set all paths and filenames if your system is 
  45. organized differently.
  46.  
  47.  
  48. BRIEF PROGRAM SETUP INSTRUCTIONS
  49. --------------------------------
  50.  
  51.      This file is intended to help the experienced user get started with 
  52. program STSORBIT PLUS (referred to as STSPLUS hereafter). It is NOT 
  53. intended to be a substitute for the full program documentation!
  54.      STSPLUS is a program to track the NASA Space Shuttle and other 
  55. satellites. The program requires NASA/NORAD 2-line elements for orbital 
  56. data and may be used with any satellite for which 2-line data is available.
  57.      The following steps should get the program "up and running" with as 
  58. little fuss and bother as practical.
  59. Program STSORBIT PLUS Satellite Orbit Simulation                   Page 2
  60.  
  61.  
  62.  
  63. 1.   A hard disk is required. It is recommended that all files be placed in 
  64.      a subdirectory called STSPLUS. If you do not have a directory for the 
  65.      program, make one with the following commands:
  66.  
  67.           C:
  68.           CD \
  69.           MD STSPLUS
  70.  
  71.      These commands assume drive C:. If you are using another drive or a 
  72.      different directory name, make the appropriate changes.
  73.  
  74. 2.   If you have modified or customized support files such as STSPLUS.CTY, 
  75.      STSPLUS.LOC, and STSPLUS.LTD, make backup copies of these files NOW! 
  76.      The installation process may overwrite these files!
  77.  
  78. 3.   Log into the STSPLUS subdirectory using the following commands (which 
  79.      assume drive C:):
  80.  
  81.           C:
  82.           CD \STSPLUS
  83.  
  84.      If the program has been received as a set of self-extracting archive 
  85.      files with names like SOP9431A.EXE, SOP9431B.EXE and EARTH3.EXE, copy 
  86.      all files from the distribution media (usually a floppy disk) to the 
  87.      STSPLUS subdirectory. For example, if your floppy drive is A:, enter 
  88.      the following command:
  89.  
  90.           COPY A:\*.* C:\STSPLUS /B
  91.  
  92. 4.   If you have used a previous version of STSPLUS, note that STSPLUS may
  93.      not read data from file STSPLUS.INI if it was written by a program 
  94.      version prior to 9332. The format of the file has changed and this 
  95.      will reset all features to their default conditions. If difficulties 
  96.      are encountered, DELETE FILE STSPLUS.INI AND RESET ALL OPTIONS 
  97.      MANUALLY!
  98.  
  99. 5.   Execute each of the EXE programs in turn; this will extract the actual 
  100.      program and data files. If you are replacing an existing installation, 
  101.      you will be asked to approve each file that may be overwritten. (The 
  102.      self-extracting archive files may be deleted if they have been saved 
  103.      on a floppy disk.)
  104.  
  105. 6.   Enter the following command to start the program:
  106.  
  107.           STSPLUS            (for all CGA/EGA/VGA color systems)
  108.  
  109.           STSPLUS /M         (for all EGA/VGA monochrome systems)
  110.  
  111. 7.   The STSPLUS.EXE file is stored on disk in compressed form. It is 
  112.      decompressed at load time; this may cause a brief delay depending upon 
  113.      the computer type used. Once the program is properly loaded, a screen 
  114.      will appear which requests that you set the UTC Offset for your time 
  115.      zone. Follow the on-screen instructions and enter the UTC Offset and 
  116.      the Daylight Flag.
  117. Program STSORBIT PLUS Satellite Orbit Simulation                   Page 3
  118.  
  119.  
  120.  
  121. 8.   Once the Main Menu is displayed, press F7 and set all paths and 
  122.      filenames. STSPLUS will default to the directory from which it was 
  123.      executed.
  124.  
  125. 9.   Many features of STSPLUS require your location. Press F10+F2 and set 
  126.      your location (STSPLUS defaults to Palos Verdes, California, near Los 
  127.      Angeles). If you do not know your latitude and longitude, pick a large 
  128.      nearby city.
  129.  
  130. 10.  The distribution package includes a set of US Space Command 2-line 
  131.      elements with a name like TLE439.TXT. This contains orbital data on 
  132.      over 170 different satellites. Press F2 to load orbital information. 
  133.      The screen will display a list of files having the extension .TXT. The 
  134.      TLEnnn.TXT file should be one of them. Enter the file name at the 
  135.      prompt and press ENTER.
  136.  
  137. 11.  The program will ask what satellite you wish to view with a default 
  138.      response of "HST" (meaning the Hubble Space Telescope). Press ENTER to 
  139.      accept the default or enter another satellite name (such as "MIR" or 
  140.      "UARS"). If the name of the data file begins with the letters "STS", 
  141.      the default satellite name will be "STS". You may also enter the 
  142.      satellite's NORAD Number, such as "#16609" for MIR.
  143.  
  144. 12.  The program will search the data file for the requested satellite and 
  145.      display its orbital data if found. If this is the satellite you wish, 
  146.      press ENTER when asked. CAUTION: Many satellite names are similar. 
  147.      Press SPACE to continue searching.
  148.  
  149. 13.  After the satellite has been selected, STSPLUS will display a map of 
  150.      the world and the ground track of the satellite. The satellite itself 
  151.      will be a white symbol along the ground track. EGA and VGA systems 
  152.      will display in color; CGA and HGC systems will display in monochrome. 
  153.  
  154. 14.  Press ENTER any time the map is displayed to return to the Main Menu.
  155.  
  156. 15.  STSPLUS has many features which are fully described in the program 
  157.      documentation. Please read that documentation!
  158.  
  159. 16.  The latest version of STSPLUS and current US Space Command 2-line 
  160.      elements are always available on my bulletin board system (BBS) noted 
  161.      at the beginning of this document. The BBS uses a power controller; 
  162.      if it hasn't answered after the THIRD RING, hang up and call back in 
  163.      two minutes. The systems are often busy, so please be patient.
  164.  
  165.  
  166. USING MISSION ELAPSED TIME WITH 2-LINE ELEMENTS
  167. -----------------------------------------------
  168.  
  169.      The standard NASA/NORAD 2-line orbital element format does NOT include 
  170. the launch time or launch date. However, this information is obviously 
  171. required if Mission Elapsed Time (MET) is to be displayed. That information 
  172. must therefore be obtained independently and manually entered into the 
  173. program. The following steps are required:
  174.  
  175. Program STSORBIT PLUS Satellite Orbit Simulation                   Page 4
  176.  
  177.  
  178. 1.   Start program STSPLUS (see above).
  179.  
  180. 2.   Load the 2-line elements for the desired satellite using Function Key 
  181.      F2 on the Main Menu. Press ENTER to return from the ground track 
  182.      display to the Main Menu.
  183.  
  184. 3.   Press Function Key F5 to enter Launch Time and Launch Date. Enter the 
  185.      appropriate information. Note that if you enter UTC or GMT Launch Time 
  186.      (by adding the letter "U" or "G" at the end of the time, upper or 
  187.      lower case), STSPLUS assumes that the date you enter will also be the 
  188.      UTC/GMT Launch Date.
  189.  
  190. 4.   The information will be displayed for approval. Press ENTER to accept 
  191.      the data, or press SPACE BAR to repeat the process.
  192.  
  193. 5.   Once the data have been accepted, press Function Key F5 while the map 
  194.      is on screen to display Mission Elapsed Time. Press F5 again to return 
  195.      to Time Elapsed Since Epoch. (Press Function Key F1 for help when the 
  196.      map is displayed with rectangular projection.) If a launch time and 
  197.      date have not been entered, the F5 command will have no effect and 
  198.      Time Since Epoch will always be displayed.
  199.  
  200. 6.   The launch time and launch date will be saved in file STSPLUS.LTD and 
  201.      need only be entered once unless it must be changed for some reason.
  202.  
  203.      NOTE: Estimated Pre-Launch 2-Line Elements for the Space Shuttle 
  204.      always use a "dummy" NORAD Number (such as "00051" for STS-51). Once 
  205.      US Space Command has assigned the actual NORAD Number, the launch time 
  206.      and date must be re-entered using the correct NORAD number.
  207.  
  208.      The simulated time, taking into account any fast time that may have 
  209. been in effect up to that point, is shown on the screen. 
  210. For reference, the local and UTC time (as determined by the computer's 
  211. internal DOS clock) are displayed. The MET (Mission Elapsed Time) or 
  212. T+Epoch shows the current elapsed time in the mission or the time since the 
  213. epoch of the orbital elements.
  214.  
  215.      The combination of the Pass Prediction feature (F3 from the Main Menu) 
  216. and the FAST and PAUSE modes will let you "look ahead" and then freeze the 
  217. display at a time of interest -- such as when the satellite enters your 
  218. circle of visibility. You can then use the "+" and "-" keys to move the 
  219. satellite position back and forward in time (using Function Key F6 to 
  220. select the time step interval, 1, 10 or 60 seconds) to determine the times 
  221. and positions throughout a pass.
  222.  
  223.  
  224. USERS WITHOUT A MATH COPROCESSOR CHIP
  225. -------------------------------------
  226.  
  227.      Operation of STSPLUS on systems not equipped with a math coprocessor 
  228. chip may not provide acceptable performance. STSPLUS makes very complex 
  229. calculations to determine the position of the Earth, one or more 
  230. Satellites, and the Sun. In addition, graphics operations required to 
  231. display the maps and satellite tracks and positions also require many 
  232. calculations. Slow computers or computers not equipped with a math 
  233. Program STSORBIT PLUS Satellite Orbit Simulation                   Page 5
  234.  
  235.  
  236. coprocessor chip (8087, 80287, 80387, etc.) may not be able to perform all 
  237. of the required calculations in an acceptable time.
  238.      Note that the Sun terminator feature is NOT automatically disabled; 
  239. however, slower computers without a math coprocessor chip may be unable to 
  240. keep up with real time if this feature is enabled. From the Main Menu, use 
  241. F10+F3+F8 to disable this feature if necessary.
  242.  
  243.  
  244. PROGRAM REGISTRATION
  245. --------------------
  246.  
  247.      See the file README for information on registering STSPLUS. While I 
  248. do not require registration of STSPLUS, I've put a great deal of time and 
  249. effort into the program for more than two years. Registering your copy and 
  250. including the very modest donation of $10.00 is a real software bargain, 
  251. and will encourage me to continue maintaining and improving the program.
  252.  
  253.                                         David H. Ransom, Jr.
  254.                                         7130 Avenida Altisima
  255.                                         Rancho Palos Verdes, CA 90275 USA
  256.  
  257.                                         CompuServe: 76240,176
  258.